Get Network List

This API is used to retrieve a list of all network operators in a given country.

HTTP URL
GET	//api/v2/global/country/{id}/network

{id} represents an ISO Alpha-3 country code.

API Request

This API has no request structure.

API Response

Response Structure

Parameter	Type	M/O/CM	Description
errorCode	String	O	Failure code. .
errorMessage	String	O	Failure message.
content	Object	O	Array of main response body object displayed when an API call was successful. For a failure, it will be empty.
pageable	Object	O	Paging information object displayed when an API call was successful. For a failure, it will be empty.

Content data objects

Element	Type	M/O/CM	Description
name	String	M	Network Operator name
mcc	String	M	Network Country Code
mnc	String	M	Mobile Network Code
plmn	String	M	Public Land Mobile Network. MCCMNC representation
providerAlias	String	O	[Future referring to eligible providers]

Pageable data objects

Element	Type	M/O/CM	Description
page	Numeric	M	Page number
size	Numeric	M	Page size. Number of requested elements per page
totalPages	Numeric	M	Total amount of available pages per requested page size
totalElements	Numeric	M	Total amount of retrieved elements

Error Codes

In addition to the general success and failure codes, the following error codes are possible.

Code	Message
GLOBAL_1001	Service unavailable. Please try again

Examples

Request Body

Copy

{

{
}

Response Body: Success ACK

Copy

{
  "errorCode": "",
  "errorMessage": "",
  "content": [
    {
      "name": "AT&T Mobility",
      "mcc": "310",
      "mnc": "380",
      "plmn": "USAAT",
      "providerAlias": ""
    },
    {
      "name": "AT&T Mobility",
      "mcc": "310",
      "mnc": "410",
      "plmn": "USACG",
      "providerAlias": ""
    },
    {
      "name": "AT&T Mobility",
      "mcc": "310",
      "mnc": "150",
      "plmn": "USACP",
      "providerAlias": ""
    },
    {
      "name": "AT&T Mobility",
      "mcc": "310",
      "mnc": "170",
      "plmn": "USAPB",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "310",
      "mnc": "580",
      "plmn": "USAUD",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "310",
      "mnc": "589",
      "plmn": "USAUE",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "310",
      "mnc": "588",
      "plmn": "USAUF",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "311",
      "mnc": "580",
      "plmn": "USADU",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "311",
      "mnc": "589",
      "plmn": "USAEU",
      "providerAlias": ""
    },
    {
      "name": "US Cellular",
      "mcc": "311",
      "mnc": "588",
      "plmn": "USAFU",
      "providerAlias": ""
    }
  ],
  "pageable": {
    "page": 1,
    "size": 10,
    "totalPages": 1,
    "totalElements": 2
  }
}

Response Body: Failure NAK

Copy

{
  "errorCode": "GLOBAL_1001",
  "errorMessage": "Service unavailable. Please try again",
  "content": "",
  "pageable": ""
}